CDKを使って、一つのLambda関数でAPI設計してみた

今回の一つのLambda関数だけを用いた構成だと、Lambda関数が一つであるためデプロイの時間を短くすることができるというメリットがあります。一方で、複数のAPIを作るために一つのLambda関数内で、httpメソッド(GET,POST,PUT,DELETE)ごとに条件分岐を行い、さらにURLごとに条件分岐する必要があります。またURLの条件分岐では正規表現が出てきます。他の人が見た時に、ぱっと見ではわかりにくいコードになってしまうというデメリットがあります。

それに対して、APIの数だけLambda関数を作成する構成だと、何度も条件分岐が出てくることは無く、正規表現も出てこないため分かりやすいコードに出来るというメリットがあります。一方で、Lambda関数が多いとその分デプロイに時間がかかるというデメリットがあります。

両方の構成のメリットとデメリットを比較すると多くの場合、APIの数だけLambda関数を作成する構成の方が良いのではと思います。しかし、今回はお勉強のために一つのLambda関数だけを用いた構成を試してみることにしました。

• データ一覧取得
  • GET https://example.com/prod/api/v1/items/
• IDが001のデータを取得
  • GET https://example.com/prod/api/v1/items/001
• データ作成
  • POST https://example.com/prod/api/v1/items
• IDが001のデータを更新
  • PUT https://example.com/prod/api/v1/items/001
• IDが001のデータを削除
  • DELETE https://example.com/prod/api/v1/items/001

Lambda関数

import { APIGatewayProxyHandlerV2 } from "aws-lambda";
import {
  DynamoDBClient,
  ScanCommand,
  ScanCommandInput,
  ...
} from "@aws-sdk/client-dynamodb";

const dynamoDBClient = new DynamoDBClient({});
const TABLE_NAME = "items";

export const handler: APIGatewayProxyHandlerV2 = async (
  event: any = {}
): Promise => {
  const requestedMethod = event.httpMethod;
  const requestedPath = event.path;
  const requestedPathParameters = event.pathParameters;
  switch (requestedMethod) {
    case "GET": {
      return getReceiver(
        requestedPath,
        requestedPathParameters ? requestedPathParameters.id : ""
      );
    }
    case "POST": {
        return postReceiver(...)
    }
    ...
    default: {
      return {
        statusCode: 400,
        body: `Error: You are missing the path parameter id`,
      };
    }
  }
};

async function getReceiver(
  requestedPath: string,
  requestedItemId: string | null
) {
  switch (true) {
    //   path=/api/v1/items/
    case /\/api\/v1\/items\/?$/.test(requestedPath): {
      const params: ScanCommandInput = {
        TableName: TABLE_NAME,
        ProjectionExpression: "itemId, itemName",
      };
      try {
        const response = await dynamoDBClient.send(new ScanCommand(params));
        return { statusCode: 200, body: JSON.stringify(response) };
      } catch (dbError) {
        return { statusCode: 500, body: JSON.stringify(dbError) };
      }
    }
    //   path=/api/v1/items/000/
    case /\/api\/v1\/items\/[0-9]{3}\/?$/.test(requestedPath): {
      ...
    }
    default: {
      return {
        statusCode: 400,
        body: `Error: You are missing the path parameter id`,
      };
    }
  }
}
...

詰まった箇所

TypeError: Cannot read property '0' of undefined

// postリクエストで受け取るbodyの型
interface WriteBody {
  itemId: string;
  itemName: string;
}

// Lambdaのhandler関数
export const handler: APIGatewayProxyHandlerV2 = async (
  event: any = {}
): Promise => {
    ...
    case "POST": {
      return postReceiver(requestedPath, event.body);
    }
    ...
}

return postReceiver(requestedPath, JSON.parse(event.body));

感想